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PROGRAM DESCRIPTION FORMAT 

To provide a standard format for program descriptions. 

December 7, 1959 

March 30, 1962 

Adherence to a standardized format in the documentation 
of a program facilitates the use of the program by 
personnel other than the originator. This bulletin 
outlines the format for program descriptions and should 
be used as a guide for contributing programs to the 
Program Library. Technical Bulletin No. 3 outlines 
the format for subroutine descriptions. 

All completed programs are issued under a PROGRA M NUMEER 
assigned by Industrial Products Programming. 

A program description will consist of the following parts! 

Title Page 

Table of Contents (if required) 

Introduction 

Method 

Restrictions 

Usage 

Coding Information 

Example 

See Appendix I or II for a sample Title Pagp. The items 
on the Title Page are self -explanatory "with th« exception 
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of the . PROGRAM CLASSIFICATION heading. The follow in? 
program classifications -will be used: 

General 

Demonstration 

Executive and Control 

Utility 

Diagnostic 

Service 

A Table of Contents is recommended for a lengthy program 
description. 

See Appendix III for the numerical format and detailed 
subheadings of the parts of a program description described 
below. See Appendix IV for layout sheets that facilitate 
program documentation* 

The INTRODUCTION should contain a statement of. the problem, 
circumstances giving rise to it, applications for its prog- 
rammed solution, and any acknowledgment. 

The 'METHOD section should discuss the technique for solving 
the problem, the accuracy of such a technique, and the equa- 
tions or formulae used (if any). Derivations of unique solu- 
tions should be given. References that might aid the reader 1 s 
comprehension should be included. 

RESTRICTIONS on the method of using the program, the equipment 

required, and the additional routines or subroutines needed 

for the program must be stated. The range, scaling, location 
and extent of data must be given. 

The section on USAGE should contain the operating instructions 
for the program. These instructions must be clearly defined. 
An explicit step-by-step procedure is recommended. Initially, 
all computer set-up configurations should be detailed, inclu- 
ding sense switch settings, pre-set stops, typewriter margins, 
and tab settings. Input instructions, including data pre- 
paration, number of digits, and sequencing, must be indicated. 
Symbols used on input or output should be explained.' The out- 
put format must be defined. Any error indications or stops 
must be given and re-start procedures explained in detail* If 
there are options as to type of problem, type of data permiss- 
ible, or variety of output, the manner of handling these options 
should be outlined. 



- 3 - 



The section on CODING INFORMATION should contain the memory 
map, location of constants, temporary storage used, timing 
required for executing a standard sized problem, and the 
flow chart. For those who require detailed knowledge of the 
program coding, the program listing or coding sheets should 
be available upon request. 

An EXAMPLE , a sample problem -with input/output, should be 
provided. The sample problem might be an interesting actual 
problem, if it adequately demonstrates use of the program. 



REFERENCES* 
INFORMATION .TO.t 
REVISED BY J 



None 

All Personnel Concerned 

H. M» Guss 

Training and Sales Support 
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PROGRAM DESCRIPTION FORMAT 



TITLE PAGE 
(AUTONETICS) 



AUTONETICS 

A DIVISION OF NORTH AMERICAN AVIATION, INC. 

INDUSTRIAL PRODUCTS 

3UOO E* 70th Street, Long Beach £, Calif, 



RECOMP PROGRAM NO. 



PROGRAM TITLE: 

PROGRAM CLASSIFICATION: 

AUTHOR: 

PURPOSE: 



DATE: 



Copyright 1962 
Autonetics Industrial Products 
A Div. of North American Aviation, Inc 
Long Beach, Calif. 
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PROGRAM DESCRIPTION FORMAT 



TITLE PAGE 
(USERS') 



RBCOMP USERS 1 PROGRAM NO, 



PROGRAM TITLE: 

PROGRAM CLASSIFICATION: 

AUTHOR: 

PURPOSE: 



DATE: 



Published by 

RECOMP Users 1 library 

at 

AUTONETICS INDUSTRIAL PRODUCTS 

A DIVISION OF NORTH AMERICAN AVIATION, INC, 

3UOO E» 70th Street, Long Beach 5, Calif. 



DISCLAIMER 

Although it is assumed that all the precautions have been 
taken to check out this program thoroughly, no responsibility 
is taken by the originator of this program for any erroneous 
results, misconceptions, or misrepresentations that may appear 
in this program. Furthermore, no responsibility is taken by 
Autcnetics Industrial Products for the correct rooroduclions of 
this program. No warranty, express or implied, is extended 
by the use or application of the program. 
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PROGRAM DESCRIPTION FORM/IT 



PROGRAM TITIEs 

1. INTRODUCTION 



Statement of the problem 
Applications 
Acknowledgment (if any) 



2. METHOD 



Techniques 

Accuracy 

Equations or formulae 

Derivations 

References 

3. RESTRICTIONS 

Required equipment 

Additional routines or subroutines needed 

Range, scaling, location, and extent of data 

h* USAGE 

Computer set-up 

Problem set-up> data preparation 

Storage requirements 

Sequential operating instructions 

Symbols used 

Output format 

Error stops 

Re-start procedures 

Options available 

£♦ CODING INFORMATION 

Location of constants 
Location of subroutines 
Temporary storage used 
Timing 
Flow chart 

6. EXAMPLE 

Sample problem with input/output 
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DATE: 



RECOMP 



PROGRAM NO. 



PROGRAM TITLE: 



PROGRAM CLASSIFICATION : 



AUTHOR: 



PURPOSE: 



TECHNICAL BIJLIETIM NO. ? 
APFEMDIX IV (continued) 



1. INTRODUCTION (Statement of Problem) 



2. METHOD (References; Derivations; Techniques) 
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APPENDIX IV (continued) 



2. METHOD (continued) 
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APPENDIX IV (continued) 



3. RESTRICTIONS (Components Required; Range, Scaling, Location, Extent of Data; 
Accuracy; Timing (if Excessive); Other Routines Required) 



k» USAGE (Computer Set-Up; Data Preparation; Storage; Sequential Operating 

Instructions; Symbols; Output; Error Indication; Options; Re-start 
Procedure; Options) 



TECHNICAL BTTLIRT^ > T 0. 2 
APPEM^ry IV ( continue -i) 



h . USAPrK ( co ntinue d) 



TF-CHtflGAL BfTIXETINT NO. ? 
APPENDIX IV (continued^ 



5. CODING INFORMATION (Constants; Memory Map; Temporary Storage; Timing' 



TECHNICAL BULLFTTN NO. 2 
APPTOIDIX IV (continued) 



6. EXAMPLE (Sample Problem with Input /Output) 



